home *** CD-ROM | disk | FTP | other *** search
Wrap
<?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="es" xml:lang="es"><head><!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> <title>Respuestas de error personalizadas - Servidor HTTP Apache</title> <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> <link href="./images/favicon.ico" rel="shortcut icon" /></head> <body id="manual-page"><div id="page-header"> <p class="menu"><a href="./mod/">M≤dulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="./faq/">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa de este sitio web</a></p> <p class="apache">Versi≤n 2.2 del Servidor HTTP Apache</p> <img alt="" src="./images/feather.gif" /></div> <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div> <div id="path"> <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentaci≤n</a> > <a href="./">Versi≤n 2.2</a></div><div id="page-content"><div id="preamble"><h1>Respuestas de error personalizadas</h1> <div class="toplang"> <p><span>Idiomas disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> | <a href="./es/custom-error.html" title="Espa±ol"> es </a> | <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <p>Apache ofrece la posibilidad de que los webmasters puedan configurar las respuestas que muestra el servidor Apache cuando se producen algunos errores o problemas.</p> <p>Las respuestas personalizadas pueden definirse para activarse en caso de que el servidor detecte un error o problema.</p> <p>Si un script termina de forma anormal y se produce una respuesta "500 Server Error", esta respuesta puede ser sustituida por otro texto de su elecci≤n o por una redirecci≤n a otra URL (local o externa).</p> </div> <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#behavior">Comportamiento</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuraci≤n</a></li> <li><img alt="" src="./images/down.gif" /> <a href="#custom">Mesajes de error personalizados y redirecciones</a></li> </ul></div> <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> <h2><a name="behavior" id="behavior">Comportamiento</a></h2> <h3>Comportamiento anterior</h3> <p>NCSA httpd 1.3 devolvφa mensajes antiguos del error o problema encontrado que con frecuencia no tenφan significado alguno para el usuario, y que no incluφan en los logs informaci≤n que diera pistas sobre las causas de lo sucedido.</p> <h3>Comportamiento actual</h3> <p>Se puede hacer que el servidor siga uno de los siguientes comportamientos:</p> <ol> <li>Desplegar un texto diferente, en lugar de los mensajes de la NCSA, o</li> <li>redireccionar la petici≤n a una URL local, o</li> <li>redireccionar la petici≤n a una URL externa.</li> </ol> <p>Redireccionar a otra URL puede resultar de utilidad, pero solo si con ello se puede tambiΘn pasar alguna informaci≤n que pueda explicar el error o problema y/o registrarlo en el log correspondiente mßs claramente.</p> <p>Para conseguir esto, Apache define ahora variables de entorno similares a las de los CGI:</p> <div class="example"><p><code> REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap, image/jpeg<br /> REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05 9000/712)<br /> REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br /> REDIRECT_QUERY_STRING=<br /> REDIRECT_REMOTE_ADDR=121.345.78.123<br /> REDIRECT_REMOTE_HOST=ooh.ahhh.com<br /> REDIRECT_SERVER_NAME=crash.bang.edu<br /> REDIRECT_SERVER_PORT=80<br /> REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br /> REDIRECT_URL=/cgi-bin/buggy.pl </code></p></div> <p>Tenga en cuenta el prefijo <code>REDIRECT_</code>.</p> <p>Al menos <code>REDIRECT_URL</code> y <code>REDIRECT_QUERY_STRING</code> se pasarßn a la nueva URL (asumiendo que es un cgi-script o un cgi-include). Las otras variables existirßn solo si existφan antes de aparecer el error o problema. <strong>Ninguna</strong> de estas variables se crearß si en la directiva <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> ha especificado una redirecci≤n <em>externa</em> (cualquier cosa que empiece por un nombre de esquema del tipo <code>http:</code>, incluso si se refiere al mismo servidor).</p> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> <h2><a name="configuration" id="configuration">Configuraci≤n</a></h2> <p>El uso de <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> estß activado para los ficheros .htaccess cuando <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> tiene el valor adecuado.</p> <p>Aquφ hay algunos ejemplos mßs...</p> <div class="example"><p><code> ErrorDocument 500 /cgi-bin/crash-recover <br /> ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br /> ErrorDocument 500 http://xxx/ <br /> ErrorDocument 404 /Lame_excuses/not_found.html <br /> ErrorDocument 401 /Subscription/how_to_subscribe.html </code></p></div> <p>La sintaxis es,</p> <div class="example"><p><code> ErrorDocument <3-digit-code> <action> </code></p></div> <p>donde action puede ser,</p> <ol> <li>Texto a mostrar. Ponga antes del texto que quiere que se muestre unas comillas ("). Lo que sea que siga a las comillas se mostrarß. <em>Nota: las comillas (") no se muestran.</em></li> <li>Una URL local a la que se redireccionarß la petici≤n.</li> <li>Una URL externa a la que se redireccionarß la petici≤n.</li> </ol> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> <div class="section"> <h2><a name="custom" id="custom">Mesajes de error personalizados y redirecciones</a></h2> <p>El comportamiento de Apache en cuanto a las redirecciones ha cambiado para que puedan usarse mßs variables de entorno con los script/server-include.</p> <h3>Antiguo comportamiento</h3> <p>Las variables CGI estßndar estaban disponibles para el script al que se hacφa la redirecci≤n. No se incluφa ninguna indicaci≤n sobre la precedencia de la redirecci≤n.</p> <h3>Nuevo comportamiento</h3> <p>Un nuevo grupo de variables de entorno se inicializa para que las use el script al que ha sido redireccionado. Cada nueva variable tendrß el prefijo <code>REDIRECT_</code>. Las variables de entorno <code>REDIRECT_</code> se crean a partir de de las variables de entorno CGI que existen antes de la redirecci≤n, se les cambia el nombre a±adiΘndoles el prefijo <code>REDIRECT_</code>, por ejemplo, <code>HTTP_USER_AGENT</code> pasa a ser <code>REDIRECT_HTTP_USER_AGENT</code>. Ademßs, para esas nuevas variables, Apache definirß <code>REDIRECT_URL</code> y <code>REDIRECT_STATUS</code> para ayudar al script a seguir su origen. Tanto la URL original como la URL a la que es redirigida la petici≤n pueden almacenarse en los logs de acceso.</p> <p>Si ErrorDocument especifica una redirecci≤n local a un script CGI, el script debe incluir una campo de cabeceraa "<code>Status:</code>" en el resultado final para asegurar que es posible hacer llegar al cliente de vuelta la condici≤n de error que lo provoc≤. Por ejemplo, un script en Perl para usar con ErrorDocument podrφa incluir lo siguiente:</p> <div class="example"><p><code> ... <br /> print "Content-type: text/html\n"; <br /> printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br /> ... </code></p></div> <p>Si el script tiene como fin tratar una determinada condici≤n de error, por ejemplo <code>404 Not Found</code>, se pueden usar los c≤digos de error y textos especφficos en su lugar.</p> <p>Tenga en cuenta que el script <em>debe</em> incluir un campo de cabecera <code>Status:</code> apropiado (como <code>302 Found</code>), si la respuesta contiene un campo de cabecera <code>Location:</code> (para poder enviar una redirecci≤n que se interprete en el cliente). De otra manera, la cabecera <code>Location:</code> puede que no tenga efecto.</p> </div></div> <div class="bottomlang"> <p><span>Idiomas disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> | <a href="./es/custom-error.html" title="Espa±ol"> es </a> | <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> <p class="apache">Copyright 1995-2006 The Apache Software Foundation or its licensors, as applicable.<br />Licencia bajo los tΘrminos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> <p class="menu"><a href="./mod/">M≤dulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="./faq/">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa de este sitio web</a></p></div> </body></html>